home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / util / rexx / AntiCron.readme < prev    next >
Encoding:
Text File  |  2001-05-03  |  7.7 KB  |  193 lines
  1. Short:    Deny program execution at certain times of the day/week. (Version 1.0b)
  2. Author:   purplet@dingoblue.net.au (Purple)
  3. Uploader: purplet@dingoblue.net.au (Purple)
  4. Type:     util/rexx
  5.  
  6.    This program enables a simple "cron" type mechanism to be used with your 
  7. programs to prevent them from being run at certain times of the day/week. I made
  8. it solely for my internet applications, such as YAM, Miami and AmIRC etc. It is
  9. very handy if you use directory tools such as Dopus, DiskMaster or DirWork, but 
  10. it is not intended to be a failsafe denial service. It is only to stop others, 
  11. such as your family members, flatmates (or girlfriend!!) etc from reading your 
  12. mail or running up your phone bill while you're at work etc. The programs can 
  13. easily be run manually to bypass AntiCron, but this was designed only to make
  14. it "look" as though there is an obvious problem by means of deception.
  15.  
  16.    With the default setting, it pops up an identical Miami requester, saying "Your
  17. modem is not responding to a reset." Most people will stop fiddling with the
  18. software if they think it is a hardware problem (Girlfriend!), or if they have
  19. no idea what a modem is anyway! (Parents!) ;-)
  20.  
  21. Installation
  22. ------------
  23.  
  24. Simply copy AntiCron.rexx and AntiCron.cfg to wherever you want, but
  25. AntiCron.rexx must be edited to point to the config file. Default is in
  26. S:AntiCron.cfg.
  27.  
  28.  
  29. Usage and Configuration
  30. -----------------------
  31.  
  32. Usage will be transparent once it is all configured.
  33.  
  34. The configuration file is simple to understand, but the order the config lines
  35. appear in MUST be left as specified below, and MUST be preceded with a * and a space.
  36.  
  37. The order of the configuration lines is below, with all comment lines stripped:
  38.  
  39. * Monday                  17:40 21:30
  40. * Tuesday    00:00 00:39  14:45 24:00
  41. * Wednesday  00:00 00:39  14:45 24:00
  42. * Thursday   00:00 00:39  14:45 24:00
  43. * Friday     00:00 00:39  14:45 24:00
  44. * Saturday   00:00 00:39             
  45. * Sunday                             
  46.  
  47. * MiamiOnline MiamiGui
  48.  
  49. * MiamiOnline     C:Miami.Online
  50. * MiamiGui        C:MiamiShow
  51.  
  52. etc etc.....
  53.  
  54. Descriptions:
  55.  
  56. DAYS      : The first 7 lines must be the days of the week. The next sets of 
  57.             two words after the day (optional) must be the start and finish 
  58.             times of a Denial Range. You may use spaces to move the ranges
  59.             accross so that they are easy to read etc. The time must be in 24
  60.             hour format only. eg 17:37 
  61.  
  62. CLIENTS   : The next single line is the list of arguments or clients that will
  63.             be denied execution if a denial match is found.
  64.  
  65. ARGUMENTS : The rest of the config lines are the individual Client arguments,
  66.             and the commands to execute when they are called. They must 
  67.             correspond to the names given in the CLIENTS line.
  68.  
  69. If you no longer want to deny a programs execution, simply remove the
  70. appropriate name from the CLIENT line only. You do not need to remove the lines
  71. from the ARGUMENTS area.
  72.  
  73. EXAMPLE:
  74.  
  75. You have a button on Dopus that does "Run >nil: MiamiOnlineNetCommand"
  76.  
  77. Change this line to "Run >nil: RX AntiCron.rexx MiamiOnline"
  78.  
  79. Then edit the config file after the days section (CLIENTS) and add the word
  80. "MiamiOnline" to the list.
  81.  
  82. Now, go to the config area after this line and add the following line:
  83.  
  84. MiamiOnline       Run >nil: MiamiOnlineNetCommand
  85.  
  86. This does the same as your original button did, but checks AntiCron.cfg to
  87. see if execution is allowed by reading the Denial Ranges for the corresponding
  88. day.
  89.  
  90.  
  91. Now, say the time is Wednesday, 16:00 hours, or 4:00 pm in 12 hour format.
  92. The script looks for the corresponding day, Wednesday, and checks all the
  93. sets of ranges it finds for the Wednesday line. 
  94.  
  95. * Wednesday  00:00 00:39  14:45 24:00
  96.               No Match      Match!!
  97.  
  98. The current time, 16:00, falls between the second range of 14:45 and 24:00, so
  99. AntiCron will NOT allow the program to be launched through it, even tho the
  100. first range does not match and allows it. The Denial Ranges, therefore, are 
  101. the times in which the clients are NOT allowed to be run. You may specify as
  102. many ranges for a day as you wish, but make sure there is both a start time AND
  103. a finish time, and that they are valid 24 hour times. There is bound to be a
  104. rexx limit on the length of characters allowed, so don't go putting in too many.
  105. Most people wouldn't need more than 5 or so though. I work at night, so I'm away
  106. during the afternoon, and a little of the morning on the following day, hence
  107. the two range setup in the supplied config file. On Sundays there is no Denial
  108. range, so access is allowed to clients all day.
  109.  
  110.  
  111. AntiCron supports some other cli arguments.
  112.  
  113. LIST       : Displays the currently configured command arguments. Some may not
  114.              deny execution if they have been removed from the CLIENT line in
  115.              the config file.
  116.  
  117.                EG. AntiCron LIST
  118.  
  119. TEST       : Does not launch the CLIENT specified , but shows the match info
  120.  
  121.              EG. AntiCron MiamiOnline TEST
  122.  
  123.                 Client Name  : MiamiOnline
  124.                 Current Time : Saturday, 18:15
  125.                 Match Found  : No Matches
  126.                 Allow Access : Yes
  127.  
  128.              This will tell you if your configuration is correct, and whether
  129.              or not AntiCron is stopping or allowing program execution
  130.              depending on the current time/day.
  131.  
  132. SHOWCONFIG : Shows the entire config file minus any comments etc (anything not
  133.              preceded with a * character)
  134.  
  135.              EG. AntiCron SHOWCONFIG
  136.  
  137.  
  138.  
  139.  
  140. You must also edit the main AntiCron.rexx file and change some settings at the
  141. top of the configuration area. These are:
  142.  
  143. ConfigFile     : Complete path to Config File
  144.  
  145. ShowRequester  : Can be either MIAMI, USER, or NO. If set to NO, the execution
  146.                  will fail silently if a match is found.
  147.  
  148. UserReqText    : Denial text to use in requester when ShowRequester is set 
  149.                  to USER
  150.  
  151. RequestDelay   : Delay before requester pops up if execution is denied.
  152.                  This is mainly for use with the MIAMI setting when using
  153.                  ShowRequester, as miami takes a few seconds to check for the
  154.                  modem and pop up its requester. makes it look more fake :)
  155.                  Set to 0 for no delay
  156.  
  157. TimeLockSwitch = Program Denial Check Switch. Easy way to turn script on or
  158.                  off without editing all your buttons in Dopus etc. If the
  159.                  dir or file in this variable exists, the script will check the
  160.                  time etc for a denial match. If the dir/file does not exist,
  161.                  the clients will all be allowed to run with no checking.
  162.  
  163. OverRideSwitch = Temporary RAM: Override Switch. Use this if you get home
  164.                  early etc and the time is still within a Denial Range. I have
  165.                  an invisible button in DirWork that I can click on that makes
  166.                  this dir. make SURE it is configured to RAM:, so when you
  167.                  reset or switch orr, the script will check again on next boot!
  168.  
  169. Bugs
  170. ----
  171.  
  172. Don't know of any. Theres not a lot of error checking for the config file
  173. layout, but its not necessary if you read the docs and check your prefs.
  174. It does look for simple mistakes by checking that you have matching range
  175. pairs, and that each time field is 5 characters long, but thats about it.
  176.  
  177. If you do find one, email me and I'll try and fix it. :)
  178.  
  179. Please mail me with any questions etc...
  180.  
  181. Regards,
  182.         Purp|e
  183.  
  184.  
  185. ============================= Archive contents =============================
  186.  
  187. Original  Packed Ratio    Date     Time    Name
  188. -------- ------- ----- --------- --------  -------------
  189.     7496    3141 58.0% 17-Mar-01 19:01:20 +AntiCron.readme
  190.     5657    1792 68.3% 17-Mar-01 19:02:18 +AntiCron.rexx
  191. -------- ------- ----- --------- --------
  192.    13153    4933 62.4% 17-Mar-101 17:21:52   2 files
  193.